home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / SOFTROCK / PD / VOYREP.ARC / Instructs next >
Text File  |  1997-01-13  |  3KB  |  121 lines
  1. VoyRep - NewsAgent Postings Search and Replace
  2. ----------------------------------------------
  3.  
  4. Please note: This is a very temporary and rush written instructions file
  5.               - sorry :-(
  6.  
  7.  
  8. To Install
  9. ----------
  10.  
  11. 1) Put the module, SRSLibrary, in your !System.Modules directory.
  12.  
  13. 2) Edit your !Voyager.Apps.News.!NewsAgent.!Run file as follows...
  14.  
  15.    Insert the following two lines at the very start
  16.  
  17.    RMEnsure SRSLibrary 0.10 RMLoad System:Modules.SRSLibrary
  18.    RMEnsure SRSLibrary 0.10 Error You need version 0.10 or higher of SRSLibrary
  19.  
  20. 3) Add the following line to the end of your
  21.    !Voyager.Apps.News.!NewsAgent.!NewsAgent file...
  22.  
  23.    Run <NewsAgent$Dir>.NewsRplace
  24.  
  25. 4) Put the Basic program, NewsRplace, and the text file, Searches, in your
  26.    !Voyager.Apps.News.!NewsAgent directory.
  27.  
  28.  
  29. Setting up Searches
  30. -------------------
  31.  
  32. The file !Voyager.Apps.News.!NewsAgent.Searches is the key to the search and
  33. replace functions carried out on your outgoing news postings.
  34.  
  35. It is a script file, instructing the program what it should do, and on what
  36. type of posting. It supports 3 commands...
  37.  
  38. #allgroups, #newgroup, and #endsearches
  39.  
  40. #endsearches
  41.  
  42.  - this should be the last line in the file.
  43.  
  44. #allgroups
  45.  
  46.  - this tells the software that all subsequent searches (up until the next
  47.    command) should be carried out on *all* postings, not those limited to a
  48.    certain newsgroup.
  49.  
  50. #newgroup
  51.  
  52.  - this command is used to limit all subsequent searches (up until the next
  53.    command) to a specific newsgroup. The format is...
  54.  
  55.    #newgroup:news.group.name
  56.  
  57.    ie the command, followed by a colon, followed by the name of the newsgroup.
  58.  
  59.    eg: #newgroup:argonet.zfc - would limit all searches to posts going to the
  60.                                newsgroup 'argonet.zfc'
  61.  
  62.  
  63. Searches
  64.  
  65.  - each search must be on it's own line and takes the format...
  66.  
  67.    searchfor::replacewith
  68.  
  69.    ie the text to find, and the text to replace it with, separated by a
  70.    double colon.
  71.  
  72.  
  73. Example Uses
  74. ------------
  75.  
  76. To stop the word computer appearing on the argonet.zfc newsgroup...
  77.  
  78. #newgroup:argonet.zfc
  79. computer::thingy
  80. Computer::Thingy
  81.  
  82. This will search for the word computer (and Computer) on any postings to the
  83. zfc newsgroup and replace it with thingy (and Thingy)
  84.  
  85.  
  86. To correct an email address according to a 'real name'...
  87.  
  88. #allgroups
  89. Joe Bloggs <email.1@some.where.com>::Joe Bloggs <email.2@some.where.com>
  90.  
  91. Note - if the last few characters of the real name are different to the real
  92.        name that relates to the email address that is included in the posting,
  93.        you could reduce the name in the search (and replace) to just those
  94.        characters. Also, if everything after the @ in the email address is the
  95.        same in both cases, that part of the address does not have to be
  96.        included. So, if the other real name in the above example is John Smith
  97.        the example could become...
  98.  
  99.        ggs <email.1@::ggs <email.2@
  100.  
  101.  
  102. Suggestion
  103. ----------
  104. Where possible, set the searches up so that the replacement text is the same
  105. length as the source text. The program will probably run a little faster.
  106.  
  107.  
  108. Copyright
  109. ---------
  110.  
  111. This program is copyright (c)1997 Soft Rock Software/Vince M. Hudd
  112.  
  113. contact: vince.mh@argonet.co.uk or softrock@argonet.co.uk
  114.  
  115.  
  116.        
  117.  
  118.  
  119.  
  120.  
  121.